Opens a sound file for use with other _Sound functions.
#include <Sound.au3>
_SoundOpen ( $hFile [, $sAlias ] )
Parameters
| $hFile | Path to sound file |
| $sAlias | Optional - A name given to the sound which is used in other functions. |
Return Value
| Success: | Sound ID |
| Failure: | 0 |
| @Error: | 0 = No Error |
| 2 = File does not exist | |
| 3 = alias contains whitespace | |
| @Extended: | 0 = No Error |
| Integer other than 0 = MCI Error |
Remarks
None.
Related
_SoundClose
Example
#include <Sound.au3>
;open sound file
$sound = _SoundOpen(@WindowsDir & "\media\Windows XP Startup.wav", "Startup")
If @error = 2 Then
MsgBox(0, "Error", "The file does not exist")
Exit
ElseIf @error = 3 Then
MsgBox(0, "Error", "The alias was invalid")
Exit
ElseIf @extended <> 0 Then
$extended = @extended ;assign because @extended will be set after DllCall
$stText = DllStructCreate("char[128]")
$errorstring = DllCall("winmm.dll","short","mciGetErrorStringA","str",$extended,"ptr",DllStructGetPtr($stText),"int",128)
MsgBox(0, "Error", "The open failed." & @CRLF & "Error Number: " & $extended & @CRLF & "Error Description: " & DllStructGetData($stText, 1) & @CRLF & "Please Note: The sound may still play correctly.")
Else
MsgBox(0, "Success", "The file opened successfully")
EndIf
_SoundClose($sound)